----------------------------------------
THE IMAGE RESIZER for vBulletin 3.7 v1.2.6
Powered with:
Lytebox / Highslide / Lightview / Slimbox / Thickbox
Floatbox / Shadowbox / Greybox / Roebox / AwesomeBox
LightWindow

(based on nCode Image Resizer for vb3.6.x)
----------------------------------------


I. What does it do
----------------------------------------
This plugin enables you to automatically resize every user-posted external
image, posted in threads, vb's blogs or even vb's albums (and group's pictures),
and in signatures (optional), which is larger than given dimensions.
Also, give (optional in admincp) options to the users, to set their own preferences
for resizing.

The Image Resizer acts in:
- External images embed in posts.
- Attachs images embed in posts.
- External images embed in blogs.
- Images in Albums / Group's pictures (optional).
- Signatures (optional) with a different width/height setting.

And the resize methods are:
- No resizing
- Enlargement in the same document
- Enlargement in the same window (replacing the forum thread document)
- Enlargement in a new window
- Enlargement using Lytebox
- Enlargement using Highslide
- Enlargement using Lightview
- Enlargement using Slimbox
- Enlargement using Thickbox
- Enlargement using Floatbox
- Enlargement using Shadowbox
- Enlargement using Greybox
- Enlargement using Roebox
- Enlargement using LightWindow
- Enlargement using AwesomeBox

It also adds an information bar when not using Lytebox/Highslide/etc (which is not
displayed when the image is too small) giving information about the original
dimensions and filesize.
Filesize is only supported on Internet Explorer, other browsers don't reveal
this information through javascript.


II. What does it not do
----------------------------------------
- It does not do server side resizing of images. Everything is done clientside
- It does not prevent long loading times. The images have to be downloaded completely
  by the client before the script can resize them.


III. Installation / Upgrade
----------------------------------------
1. Upload the contents of the "clientscript" folder to your vBulletin's clientscript folder.
	You will have:
			forums/clientscript/ncode_imageresizer.js
			forums/clientscript/lytebox/*.*
			forums/clientscript/highslide/*.*
			forums/clientscript/lightview/*.*
			forums/clientscript/slimbox/*.*
			forums/clientscript/thickbox/*.*
			forums/clientscript/floatbox/*.*
			forums/clientscript/shadowbox/*.*
			forums/clientscript/greybox/*.*
			forums/clientscript/roebox/*.*
			forums/clientscript/lightwindow/*.*
			forums/clientscript/awesomebox/*.*

2. Import "product-tcattd_extimageresizer.xml" in your vBulletin forum. Enter your AdminCP
   and go to Plugins & Products -> Manage Products. Click on [Add/Import Product] and
   refer to the XML file.
	Allow Overwrite -> Yes.

3. You're done.

* Upgrading.
	If you're using old (but great!) nCode Image Resizer for vb3.6.x or Jase2 port
	for vb3.7 (the reason for keep this update; is a great mod, even Jase2 port is cool)
	then you need to uninstall your old version first from your vBulletin's
	Product Manager.
	Then, perform an installation from the beginning... and configure it
	in your AdminCP ;)


IV. Configuration
----------------------------------------
Go to your AdminCP -> vBulletin Options -> External Image Resizer - Options
...and configure this mod as you like.

You NEED to check the respective resizer's website for options and configuration,
and edit the corresponding javascript file in the
/clientscript/<em>YOURCHOICE</em>/ folder.
Just Highslide have (one...) options in the AdminCP.
Also check the templates like: tcattd_imageresizer_headinclude_highslide,
tcattd_imageresizer_headinclude_lightview, tcattd_imageresizer_headinclude_lytebox,
etc. for an easy customization (put the javascript's vars in there, direct.
Like Highslide or Floatbox examples).


V. Know issues
----------------------------------------
1.- Images with a link pointing to some url, will not work with the default IMG-tag.
This because all this Lightbox like resizers need to put a link to the original-full
image.
	To "solve" this issue, The Image Resizer creates a new BBcode on install (v1.2.6
	and above). Check the associated help in the AdminCP to know about it and
	how to use.

2.- In the AdminCP, some Lightboxes are mark with an *
Those and possible others too (is relative to YOUR vb's STYLE) have some
conflicts between them, an overloaded vb's style, and Internet Explorer.
It's an Internet Explorer BUG!. I can do nothing about that.
You will notice this bug in IE, because it will show up this message:
"Internet Explorer could not open... Operation aborted."

How to test it?. Just change to the vbulletin's default style, and try the conflictive
Lightbox choice. They will work without problems.
This happen even with the vb's default Lightbox. Check this out:
http://www.vbulletin.com/forum/showthread.php?t=252682

Then, your choices are: - Use a different Resizer option (Lytebox and Highslide works
	fine almost all the time)
	- Try to clean up your style/vbulletin.
	In one conflictive installation i disabled vbadvanced integration,
	and IExplorer start working ok with Lightview.
	vbadvanced put a lot of nested tables for integration (load the entire
	adv_portal template to load the rest of the website; plus the tables and
	divs from the loaded blocks/modules).
	Is the quantity of tables and divs, in excess and nested, that cause IExplorer
	to crash.
	- Third: again, it's not "the image resizer"'s fault. It's an IExplorer
	bug. So, clean your vb's style, or choose a non-conflictive Resizer.
	Lytebox, Highslide or Thickbox works fine.


VI. Version history
----------------------------------------
1.2.6 (July 28th, 2008)
- Added. New autocreated on install BBcode: [IMGLINK]
	This BBcode will "solve" the know issue number one, about embed images with a link
	[URL] tag arround them to use as button for links.
	For more details, refer to the AdminCP option and associated Help on that item.
- Added. Optional resizing of the new BBcode [IMGLINK]. If yes, images posted with
	the new BBcode will be downsized, but no lightbox will be attached to them, so
	links with [URL] still works and don't mess up your layout too.
- Added. A new option in AdminCP to "allow only change dimensions" in users profiles options.
	So, now you have: allow all options, allow resize mode selecion, allow resize mode
	selection and change dimensions, allow only change dimensions.
	For more details, refer to the AdminCP option and associated Help on that item.
- Fixed. LightWindow was integrated in v1.2.5, but the option-item in the AdminCP was
	missing. LOL
	Working now.
- Fixed. Highslide image paths (css don't work properly and can't display loader and fullexpand images)
- Fixed. The layout of the UserCP -> Profile Options for The Image Resizer (now a proper "fieldset" is set)
- Updated. Highslide to v3.3.22
- Updated. Slimbox to v1.64

	To upgrade you need to:
	- upload (and overwrite) the new folder /clientscript/highslide/
	- upload (and overwrite) the new folder /clientscript/slimbox/
	- upload (if missing) the folder /clientscript/lightwindow/
	Then, re-import the new 1.2.6 product (allow overwrite = yes).


1.2.5 (July 22th, 2008)
- Added. New resizers: Floatbox, Shadowbox, Greybox, Roebox, Lightwindow, AwesomeBox.
- Added. New options to set different width and height for Signature's image
	resizing and Album's image resizing. Check the AdminCP options for configuration.
- Added. New option to exclude usergroups (by IDs) from Signature resizing.
- Added. An option to disable the Resizing of pictures in vb's albums / group's pictures.
	Some people don't like and don't use that.
- Clean. Cleaned up "the function" for search/replace.
- Fixed. Removed the ugly border from the images in Albums and Group's Pictures
	(forgot to put a border="0" in the img tag for the Lightbox's link).

	To upgrade you need to upload all the new /clientscript/ files
	and folders again. Overwrite the javascripts! (yes, overwrite the ncode_imageresizer.js).
	Then, import the new 1.2.5 product (allow overwrite = yes).


1.2.4 (July 19th, 2008)
- Added. New resizers: Lightview, Slimbox, Thickbox.

	To upgrade, you need to upload all the new /clientscript/ files
	and folders!. Then, import the new 1.2.4 product (allow overwrite = yes).

1.2.3 (June 7th, 2008)
- Added. Option "Replace Lightbox for Attached files?" in the AdminCP.
	When you turn that on, all default vb's Lightbox will be replaced
	with Lytebox/Highslide, only if you are using one of those two
	options as your "Default Resize Mode". Now, your attached images
	will be open with Lytebox/Highslide.
	Old references to Lightbox javascript are hidden (Set $show['lightbox']
	to false). 

	To upgrade, just import the new 1.2.3 product (allow overwrite = yes).
	No need to re-upload the files.

1.2.2 (June 7th, 2008)
- Fixed, set "Clear User Settings" to yes in AdminCP, not clear data.
	Thanks to Stoebi!
- Fixed, images from Albums added to Groups don't get resized (they use
	a different template from pictures displayed in Albums)
	Thanks Calash for pointing the bug.

1.2.1 (June 7th, 2008)
- Change. Moved the conditional in template:
	ncode_imageresizer_headinclude
	...in order to show less CSS when using Lytebox or Highslide.
	Just one new CSS definition will be added (when using Lytebox/Highslide)
	If you customized this template, revert it to reflect the changes.

	To upgrade, just import the new 1.2.1 product (allow overwrite = yes).
	No need to re-upload the files.

1.2.0 (June 6th, 2008)
- TCattitude take Spleasure's work with his permission, and continue from
	vbulletin 3.6.x mod, porting it to vbulletin 3.7.x
- Add options to use Lytebox or Highslide to show full image.
- Add options to customize the Warn-Bar color, text color and border.
- fixed resizing images posted in vb's blogs.
- fixed resizing images posted in vb's albums. Now you can set a more larger width
	in usergroup permissions, and allow "External Image Resizer" to resize down more
	to not mess up your layout.
- fixed to not show Warn-Bar when you use Lytebox or Highslide. Instead: Mouse-over
	warning.

1.0.1 (May 6th, 2007)
- fixed javascript file version
- fixed vBAdvanced compatibility problem

1.0 (April 24th, 2007)
- added code to make phrases javascript safe, multiline phrases and phrases with accents
  should work now.
- added compatibility with vBAdvanced
- improved installation procedure

1.0 release candidate 4 (February 21th, 2007)
- improved speed for posts with many small images
- work around for text display problem in Safari
- Improved installer
- Improved user control panel options: added information about default settings and option
  to explicitly use the default resize mode.
- Added option to disable the system
- Added option to reset all user specific settings

1.0 release candidate 3 (February 4th, 2007)
- added warning on installation when javascript is
  not present.
- removed redundant plugins
- small bugfixes
- signature resizing is optional. turn resizing of
  hotlinked images on or off in the control panel
- improvements in javascript code
- changed hook method so all bbcode class users get
  resize functionality automatically

1.0 release candidate 2 (October 3rd, 2006)
- images weren't correctly resized when both
  height and width restrictions were in effect.
- added robustness for IE flaws, not perfect yet
- images in post previews get resized as well

1.0 release candidate 1 (Juli 16th, 2006)
- bug preventing proper uninstallation fixed

1.0 beta 3 (June 23th, 2006)
- Bugfixes
- Now resizes signaturepictures too
- Administrators can limit the user-settable options

1.0 beta 2 (June 20th, 2006)
- Made maximum width and height userspecific and editable

1.0 beta 1 (June 8th, 2006)
- First public release


VII. Copyrights, Licenses
----------------------------------------
Original idea and code: Spleasure (@ ncode.nl)
Re-Port to vbulletin 3.7.x and enhanced by: TCattitude (@ attitude.cl)
...with Spleasure's permission ;)

You are allowed to install this in your forum, and you are allowed to make suggestions
for improvements. It is not allowed to redistribute the files in any other way than
as a zipfile with the XML, all the other files in it, and this readme in his original state.

IMPORTANT!!!
Copyrights for all the "resizers" mods, the Lightboxes, has their own home pages at:
    * Lytebox: http://www.dolem.com/lytebox/
    * Lightview: http://www.nickstakenburg.com/projects/lightview/
    * Slimbox: http://www.digitalia.be/software/slimbox/
    * Thickbox: http://jquery.com/demo/thickbox/
    * Floatbox: http://randomous.com/tools/floatbox/
    * Shadowbox: http://mjijackson.com/shadowbox/
    * Greybox: http://orangoo.com/labs/greybox/
    * Roebox: http://www.roebox.com/
    * AwesomeBox: http://paularmstrongdesigns.com/projects/awesomebox/
    * LightWindow: http://www.stickmanlabs.com/lightwindow/
    * Highslide: http://vikjavev.no/highslide/
...consider them, their copyright and licenses BEFORE you use/install this in your
site and use them as your options to show the full images.


Thanks
----------------------------------------
Thanks to Spleasure for the permission to use his javascript and work.
I made another mod, more minimalistic, for resize external posted images
in several vbulletin website that i manage. But my javascript skills are
nor really the best, so i was using some other JS functions that i found
online. But nothing like nCode's one.

So he gave me permission to use his JS, and to use the first fork I did
from nCode's plugin-product for vbulletin 3.6.x. So i drop my own
minimalistic version of the image-resize plugin-product, polished the fork (put options and more friendly for admins), and make a
"second version" of nCode's one.

And this is it: nCode Image Resizer -> The Image Resizer.
Now powered with Lytebox or Highslide! (optional)
